@assistant-ui/react-streamdown 0.0.0

package/README.md

@@ -0,0 +1,163 @@
+# @assistant-ui/react-streamdown
+
+Streamdown-based markdown rendering for assistant-ui. An alternative to `@assistant-ui/react-markdown` with built-in syntax highlighting, math, and diagram support.
+
+## When to Use
+
+| Package | Best For |
+|---------|----------|
+| `@assistant-ui/react-markdown` | Lightweight, bring-your-own syntax highlighter |
+| `@assistant-ui/react-streamdown` | Feature-rich with built-in Shiki, KaTeX, Mermaid |
+
+## Installation
+
+```bash
+npm install @assistant-ui/react-streamdown streamdown
+```
+
+For additional features, install the optional plugins:
+
+```bash
+npm install @streamdown/code @streamdown/math @streamdown/mermaid @streamdown/cjk
+```
+
+## Usage
+
+### Basic
+
+```tsx
+import { StreamdownTextPrimitive } from "@assistant-ui/react-streamdown";
+
+// Inside a MessagePartText component
+<StreamdownTextPrimitive />
+```
+
+### With Plugins (Recommended)
+
+```tsx
+import { StreamdownTextPrimitive } from "@assistant-ui/react-streamdown";
+import { code } from "@streamdown/code";
+import { math } from "@streamdown/math";
+import { mermaid } from "@streamdown/mermaid";
+import "katex/dist/katex.min.css";
+
+<StreamdownTextPrimitive
+  plugins={{ code, math, mermaid }}
+  shikiTheme={["github-light", "github-dark"]}
+/>
+```
+
+### Migration from react-markdown
+
+If you're migrating from `@assistant-ui/react-markdown`, you can use the compatibility API:
+
+```tsx
+import { StreamdownTextPrimitive } from "@assistant-ui/react-streamdown";
+
+// Your existing SyntaxHighlighter component still works
+<StreamdownTextPrimitive
+  components={{
+    SyntaxHighlighter: MySyntaxHighlighter,
+    CodeHeader: MyCodeHeader,
+  }}
+  componentsByLanguage={{
+    mermaid: { SyntaxHighlighter: MermaidRenderer }
+  }}
+/>
+```
+
+## Props
+
+| Prop | Type | Description |
+|------|------|-------------|
+| `mode` | `"streaming" \| "static"` | Rendering mode. Default: `"streaming"` |
+| `plugins` | `PluginConfig` | Streamdown plugins (code, math, mermaid, cjk) |
+| `shikiTheme` | `[string, string]` | Light and dark theme for Shiki |
+| `components` | `object` | Custom components including `SyntaxHighlighter` and `CodeHeader` |
+| `componentsByLanguage` | `object` | Language-specific component overrides |
+| `preprocess` | `(text: string) => string` | Text preprocessing function |
+| `controls` | `boolean \| object` | Enable/disable UI controls for code blocks and tables |
+| `containerProps` | `object` | Props for the container div |
+| `containerClassName` | `string` | Class name for the container |
+| `remarkRehypeOptions` | `object` | Options passed to remark-rehype during processing |
+| `BlockComponent` | `React.ComponentType` | Custom component for rendering blocks |
+| `parseMarkdownIntoBlocksFn` | `(md: string) => string[]` | Custom block parsing function |
+| `remend` | `object` | Incomplete markdown auto-completion config |
+| `linkSafety` | `object` | Link safety confirmation config |
+| `mermaid` | `object` | Mermaid diagram rendering config |
+| `allowedTags` | `object` | HTML tags whitelist |
+
+## Differences from react-markdown
+
+1. **Streaming optimization**: Uses block-based rendering and `remend` for better streaming performance
+2. **Built-in highlighting**: Shiki is integrated via `@streamdown/code` plugin
+3. **No smooth prop**: Streaming animation is handled by streamdown's `mode` and `isAnimating`
+4. **Auto isAnimating**: Automatically detects streaming state from message context
+
+## Advanced Usage
+
+### Custom Block Rendering
+
+Use `BlockComponent` to customize how individual markdown blocks are rendered:
+
+```tsx
+<StreamdownTextPrimitive
+  BlockComponent={({ content, index }) => (
+    <div key={index} className="my-block">
+      {/* Custom block rendering */}
+    </div>
+  )}
+/>
+```
+
+### Custom Block Parsing
+
+Override the default block splitting logic:
+
+```tsx
+<StreamdownTextPrimitive
+  parseMarkdownIntoBlocksFn={(markdown) => markdown.split(/\n{2,}/)}
+/>
+```
+
+### Using Hooks
+
+```tsx
+import {
+  useIsStreamdownCodeBlock,
+  useStreamdownPreProps,
+} from "@assistant-ui/react-streamdown";
+
+// Inside a code component
+function MyCodeComponent() {
+  const isCodeBlock = useIsStreamdownCodeBlock();
+  const preProps = useStreamdownPreProps();
+
+  if (!isCodeBlock) {
+    return <code className="inline-code">...</code>;
+  }
+
+  return <pre {...preProps}>...</pre>;
+}
+```
+
+## Performance Best Practices
+
+1. **Use memoized components**: Custom `SyntaxHighlighter` and `CodeHeader` components should be memoized to avoid unnecessary re-renders.
+
+2. **Avoid inline function props**: Define `preprocess`, `parseMarkdownIntoBlocksFn`, and other callbacks outside the render function or wrap them in `useCallback`.
+
+3. **Plugin configuration**: Pass plugin objects by reference (not inline) to prevent recreation on each render.
+
+```tsx
+// Good
+const plugins = useMemo(() => ({ code, math }), []);
+<StreamdownTextPrimitive plugins={plugins} />
+
+// Avoid
+<StreamdownTextPrimitive plugins={{ code, math }} />
+```
+
+## License
+
+MIT

package/dist/adapters/PreOverride.d.ts

@@ -0,0 +1,27 @@
+import type { Element } from "hast";
+import { type ComponentPropsWithoutRef } from "react";
+type PreOverrideProps = ComponentPropsWithoutRef<"pre"> & {
+    node?: Element | undefined;
+};
+/**
+ * Context that indicates we're inside a <pre> element (code block).
+ * Used by code adapter to distinguish inline code from block code.
+ */
+export declare const PreContext: import("react").Context<PreOverrideProps | null>;
+/**
+ * Hook to check if the current code element is inside a code block.
+ * Returns true if inside a <pre> (code block), false if inline code.
+ */
+export declare function useIsStreamdownCodeBlock(): boolean;
+/**
+ * Hook to get the pre element props when inside a code block.
+ * Returns null if not inside a code block.
+ */
+export declare function useStreamdownPreProps(): PreOverrideProps | null;
+/**
+ * Pre component override that provides context for child code elements.
+ * This enables reliable inline vs block code detection.
+ */
+export declare const PreOverride: import("react").NamedExoticComponent<PreOverrideProps>;
+export {};
+//# sourceMappingURL=PreOverride.d.ts.map

package/dist/adapters/PreOverride.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreOverride.d.ts","sourceRoot":"","sources":["../../src/adapters/PreOverride.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,EACL,KAAK,wBAAwB,EAI9B,MAAM,OAAO,CAAC;AAGf,KAAK,gBAAgB,GAAG,wBAAwB,CAAC,KAAK,CAAC,GAAG;IACxD,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,kDAA+C,CAAC;AAEvE;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,gBAAgB,GAAG,IAAI,CAE/D;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,wDAUJ,CAAC"}

package/dist/adapters/PreOverride.js

@@ -0,0 +1,31 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, memo, useContext, } from "react";
+import { memoCompareNodes } from "../memoization.js";
+/**
+ * Context that indicates we're inside a <pre> element (code block).
+ * Used by code adapter to distinguish inline code from block code.
+ */
+export const PreContext = createContext(null);
+/**
+ * Hook to check if the current code element is inside a code block.
+ * Returns true if inside a <pre> (code block), false if inline code.
+ */
+export function useIsStreamdownCodeBlock() {
+    return useContext(PreContext) !== null;
+}
+/**
+ * Hook to get the pre element props when inside a code block.
+ * Returns null if not inside a code block.
+ */
+export function useStreamdownPreProps() {
+    return useContext(PreContext);
+}
+/**
+ * Pre component override that provides context for child code elements.
+ * This enables reliable inline vs block code detection.
+ */
+export const PreOverride = memo(function PreOverride({ children, node, ...rest }) {
+    return (_jsx(PreContext.Provider, { value: { node, ...rest }, children: _jsx("pre", { ...rest, children: children }) }));
+}, memoCompareNodes);
+//# sourceMappingURL=PreOverride.js.map

package/dist/adapters/PreOverride.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreOverride.js","sourceRoot":"","sources":["../../src/adapters/PreOverride.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAEL,aAAa,EACb,IAAI,EACJ,UAAU,GACX,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,gBAAgB,EAAE,0BAAuB;AAMlD;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAA0B,IAAI,CAAC,CAAC;AAEvE;;;GAGG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,UAAU,CAAC,UAAU,CAAC,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,WAAW,CAAC,EACnD,QAAQ,EACR,IAAI,EACJ,GAAG,IAAI,EACU;IACjB,OAAO,CACL,KAAC,UAAU,CAAC,QAAQ,IAAC,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,YAC3C,iBAAS,IAAI,YAAG,QAAQ,GAAO,GACX,CACvB,CAAC;AACJ,CAAC,EAAE,gBAAgB,CAAC,CAAC"}

package/dist/adapters/code-adapter.d.ts

@@ -0,0 +1,22 @@
+import type { Element } from "hast";
+import { type ComponentPropsWithoutRef, type ComponentType } from "react";
+import type { CodeHeaderProps, ComponentsByLanguage, SyntaxHighlighterProps } from "../types.js";
+type CodeProps = ComponentPropsWithoutRef<"code"> & {
+    node?: Element | undefined;
+};
+interface CodeAdapterOptions {
+    SyntaxHighlighter?: ComponentType<SyntaxHighlighterProps> | undefined;
+    CodeHeader?: ComponentType<CodeHeaderProps> | undefined;
+    componentsByLanguage?: ComponentsByLanguage | undefined;
+}
+/**
+ * Creates a code component adapter that bridges the assistant-ui
+ * SyntaxHighlighter/CodeHeader API to streamdown's code component.
+ */
+export declare function createCodeAdapter(options: CodeAdapterOptions): import("react").MemoExoticComponent<({ node, className, children, ...props }: CodeProps) => import("react/jsx-runtime").JSX.Element | null>;
+/**
+ * Checks if the code adapter should be used (i.e., user provided custom components).
+ */
+export declare function shouldUseCodeAdapter(options: CodeAdapterOptions): boolean;
+export {};
+//# sourceMappingURL=code-adapter.d.ts.map

package/dist/adapters/code-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/code-adapter.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,aAAa,EAInB,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACvB,oBAAiB;AAKlB,KAAK,SAAS,GAAG,wBAAwB,CAAC,MAAM,CAAC,GAAG;IAClD,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC5B,CAAC;AAMF,UAAU,kBAAkB;IAC1B,iBAAiB,CAAC,EAAE,aAAa,CAAC,sBAAsB,CAAC,GAAG,SAAS,CAAC;IACtE,UAAU,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,GAAG,SAAS,CAAC;IACxD,oBAAoB,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;CACzD;AAwBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,iFAexD,SAAS,qDA6Db;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAOzE"}

package/dist/adapters/code-adapter.js

@@ -0,0 +1,75 @@
+"use client";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { isValidElement, memo, } from "react";
+import { useIsStreamdownCodeBlock } from "./PreOverride.js";
+const LANGUAGE_REGEX = /language-([^\s]+)/;
+/**
+ * Extracts code string from children.
+ */
+function extractCode(children) {
+    if (typeof children === "string")
+        return children;
+    if (!isValidElement(children))
+        return "";
+    const props = children.props;
+    if (props && typeof props["children"] === "string") {
+        return props["children"];
+    }
+    return "";
+}
+function DefaultPre({ node: _, ...props }) {
+    return _jsx("pre", { ...props });
+}
+function DefaultCode({ node: _, ...props }) {
+    return _jsx("code", { ...props });
+}
+/**
+ * Creates a code component adapter that bridges the assistant-ui
+ * SyntaxHighlighter/CodeHeader API to streamdown's code component.
+ */
+export function createCodeAdapter(options) {
+    const { SyntaxHighlighter: UserSyntaxHighlighter, CodeHeader: UserCodeHeader, componentsByLanguage = {}, } = options;
+    /**
+     * Inner component that uses the hook for inline/block detection.
+     */
+    function AdaptedCodeInner({ node, className, children, ...props }) {
+        // Use context-based detection for inline vs block code
+        const isCodeBlock = useIsStreamdownCodeBlock();
+        if (!isCodeBlock) {
+            // Inline code - render as simple code element
+            return (_jsx("code", { className: `aui-streamdown-inline-code ${className ?? ""}`.trim(), ...props, children: children }));
+        }
+        // Block code - extract language and code content
+        const match = className?.match(LANGUAGE_REGEX);
+        const language = match?.[1] ?? "";
+        const code = extractCode(children);
+        // Get language-specific or fallback components
+        const SyntaxHighlighter = componentsByLanguage[language]?.SyntaxHighlighter ??
+            UserSyntaxHighlighter;
+        const CodeHeader = componentsByLanguage[language]?.CodeHeader ?? UserCodeHeader;
+        // If user provided custom SyntaxHighlighter, use it
+        if (SyntaxHighlighter) {
+            return (_jsxs(_Fragment, { children: [CodeHeader && (_jsx(CodeHeader, { node: node, language: language, code: code })), _jsx(SyntaxHighlighter, { node: node, components: { Pre: DefaultPre, Code: DefaultCode }, language: language, code: code })] }));
+        }
+        // No custom SyntaxHighlighter - return null to let streamdown handle it
+        // This signals to the adapter that we should use streamdown's default
+        return null;
+    }
+    const AdaptedCode = memo(AdaptedCodeInner, (prev, next) => {
+        return (prev.className === next.className &&
+            prev.children === next.children &&
+            prev.node?.position?.start.line === next.node?.position?.start.line &&
+            prev.node?.position?.end.line === next.node?.position?.end.line);
+    });
+    return AdaptedCode;
+}
+/**
+ * Checks if the code adapter should be used (i.e., user provided custom components).
+ */
+export function shouldUseCodeAdapter(options) {
+    return !!(options.SyntaxHighlighter ||
+        options.CodeHeader ||
+        (options.componentsByLanguage &&
+            Object.keys(options.componentsByLanguage).length > 0));
+}
+//# sourceMappingURL=code-adapter.js.map

package/dist/adapters/code-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-adapter.js","sourceRoot":"","sources":["../../src/adapters/code-adapter.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAGL,cAAc,EACd,IAAI,GAEL,MAAM,OAAO,CAAC;AAMf,OAAO,EAAE,wBAAwB,EAAE,yBAAsB;AAEzD,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAgB3C;;GAEG;AACH,SAAS,WAAW,CAAC,QAAiB;IACpC,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAClD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IAEzC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAuC,CAAC;IAC/D,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,UAAU,CAAC,KAAK,QAAQ,EAAE,CAAC;QACnD,OAAO,KAAK,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,EAAY;IACjD,OAAO,iBAAS,KAAK,GAAI,CAAC;AAC5B,CAAC;AAED,SAAS,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,EAAa;IACnD,OAAO,kBAAU,KAAK,GAAI,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC3D,MAAM,EACJ,iBAAiB,EAAE,qBAAqB,EACxC,UAAU,EAAE,cAAc,EAC1B,oBAAoB,GAAG,EAAE,GAC1B,GAAG,OAAO,CAAC;IAEZ;;OAEG;IACH,SAAS,gBAAgB,CAAC,EACxB,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACE;QACV,uDAAuD;QACvD,MAAM,WAAW,GAAG,wBAAwB,EAAE,CAAC;QAE/C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,8CAA8C;YAC9C,OAAO,CACL,eACE,SAAS,EAAE,8BAA8B,SAAS,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,KAC7D,KAAK,YAER,QAAQ,GACJ,CACR,CAAC;QACJ,CAAC;QAED,iDAAiD;QACjD,MAAM,KAAK,GAAG,SAAS,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;QAEnC,+CAA+C;QAC/C,MAAM,iBAAiB,GACrB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,iBAAiB;YACjD,qBAAqB,CAAC;QAExB,MAAM,UAAU,GACd,oBAAoB,CAAC,QAAQ,CAAC,EAAE,UAAU,IAAI,cAAc,CAAC;QAE/D,oDAAoD;QACpD,IAAI,iBAAiB,EAAE,CAAC;YACtB,OAAO,CACL,8BACG,UAAU,IAAI,CACb,KAAC,UAAU,IAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAI,CAC3D,EACD,KAAC,iBAAiB,IAChB,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,EAClD,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,IAAI,GACV,IACD,CACJ,CAAC;QACJ,CAAC;QAED,wEAAwE;QACxE,sEAAsE;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;QACxD,OAAO,CACL,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS;YACjC,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ;YAC/B,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI;YACnE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,CAChE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA2B;IAC9D,OAAO,CAAC,CAAC,CACP,OAAO,CAAC,iBAAiB;QACzB,OAAO,CAAC,UAAU;QAClB,CAAC,OAAO,CAAC,oBAAoB;YAC3B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CACxD,CAAC;AACJ,CAAC"}

package/dist/adapters/components-adapter.d.ts

@@ -0,0 +1,18 @@
+import type { StreamdownProps } from "streamdown";
+import type { ComponentsByLanguage, StreamdownTextComponents } from "../types.js";
+interface UseAdaptedComponentsOptions {
+    components?: StreamdownTextComponents | undefined;
+    componentsByLanguage?: ComponentsByLanguage | undefined;
+}
+/**
+ * Hook that adapts assistant-ui component API to streamdown's component API.
+ *
+ * Handles:
+ * - SyntaxHighlighter -> custom code component
+ * - CodeHeader -> custom code component
+ * - componentsByLanguage -> custom code component with language dispatch
+ * - PreOverride -> context-based inline/block code detection
+ */
+export declare function useAdaptedComponents({ components, componentsByLanguage, }: UseAdaptedComponentsOptions): StreamdownProps["components"];
+export {};
+//# sourceMappingURL=components-adapter.d.ts.map

package/dist/adapters/components-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/components-adapter.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,oBAAiB;AAE/E,UAAU,2BAA2B;IACnC,UAAU,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAClD,oBAAoB,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;CACzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,UAAU,EACV,oBAAoB,GACrB,EAAE,2BAA2B,GAAG,eAAe,CAAC,YAAY,CAAC,CAyB7D"}

package/dist/adapters/components-adapter.js

@@ -0,0 +1,34 @@
+"use client";
+import { useMemo } from "react";
+import { createCodeAdapter, shouldUseCodeAdapter } from "./code-adapter.js";
+import { PreOverride } from "./PreOverride.js";
+/**
+ * Hook that adapts assistant-ui component API to streamdown's component API.
+ *
+ * Handles:
+ * - SyntaxHighlighter -> custom code component
+ * - CodeHeader -> custom code component
+ * - componentsByLanguage -> custom code component with language dispatch
+ * - PreOverride -> context-based inline/block code detection
+ */
+export function useAdaptedComponents({ components, componentsByLanguage, }) {
+    return useMemo(() => {
+        const { SyntaxHighlighter, CodeHeader, ...htmlComponents } = components ?? {};
+        const codeAdapterOptions = {
+            SyntaxHighlighter,
+            CodeHeader,
+            componentsByLanguage,
+        };
+        const baseComponents = { pre: PreOverride };
+        if (!shouldUseCodeAdapter(codeAdapterOptions)) {
+            return { ...htmlComponents, ...baseComponents };
+        }
+        const AdaptedCode = createCodeAdapter(codeAdapterOptions);
+        return {
+            ...htmlComponents,
+            ...baseComponents,
+            code: (props) => AdaptedCode(props) ?? undefined,
+        };
+    }, [components, componentsByLanguage]);
+}
+//# sourceMappingURL=components-adapter.js.map

package/dist/adapters/components-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components-adapter.js","sourceRoot":"","sources":["../../src/adapters/components-adapter.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,0BAAuB;AACzE,OAAO,EAAE,WAAW,EAAE,yBAAsB;AAQ5C;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,EACnC,UAAU,EACV,oBAAoB,GACQ;IAC5B,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,GAAG,cAAc,EAAE,GACxD,UAAU,IAAI,EAAE,CAAC;QAEnB,MAAM,kBAAkB,GAAG;YACzB,iBAAiB;YACjB,UAAU;YACV,oBAAoB;SACrB,CAAC;QAEF,MAAM,cAAc,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC;QAE5C,IAAI,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC9C,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,cAAc,EAAE,CAAC;QAClD,CAAC;QAED,MAAM,WAAW,GAAG,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;QAE1D,OAAO;YACL,GAAG,cAAc;YACjB,GAAG,cAAc;YACjB,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,SAAS;SACjD,CAAC;IACJ,CAAC,EAAE,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/defaults.d.ts

@@ -0,0 +1,18 @@
+import type { BundledTheme } from "streamdown";
+import type { PluginConfig, ResolvedPluginConfig } from "./types.js";
+/**
+ * Default Shiki theme for code highlighting.
+ * First value is light theme, second is dark theme.
+ */
+export declare const DEFAULT_SHIKI_THEME: [BundledTheme, BundledTheme];
+/**
+ * Merges user plugin configuration with detected defaults.
+ *
+ * Rules:
+ * - `false` = explicitly disable a plugin
+ * - `undefined` = use default (auto-detect)
+ * - plugin instance = use provided plugin
+ * - mermaid requires explicit enabling (not auto-detected)
+ */
+export declare function mergePlugins(userPlugins: PluginConfig | undefined, defaultPlugins: ResolvedPluginConfig): ResolvedPluginConfig;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,mBAAgB;AAElE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,CAAC,YAAY,EAAE,YAAY,CAG5D,CAAC;AAIF;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,YAAY,GAAG,SAAS,EACrC,cAAc,EAAE,oBAAoB,GACnC,oBAAoB,CAiBtB"}

package/dist/defaults.js

@@ -0,0 +1,37 @@
+"use client";
+/**
+ * Default Shiki theme for code highlighting.
+ * First value is light theme, second is dark theme.
+ */
+export const DEFAULT_SHIKI_THEME = [
+    "github-light",
+    "github-dark",
+];
+const PLUGIN_KEYS = ["code", "math", "cjk"];
+/**
+ * Merges user plugin configuration with detected defaults.
+ *
+ * Rules:
+ * - `false` = explicitly disable a plugin
+ * - `undefined` = use default (auto-detect)
+ * - plugin instance = use provided plugin
+ * - mermaid requires explicit enabling (not auto-detected)
+ */
+export function mergePlugins(userPlugins, defaultPlugins) {
+    const result = {};
+    for (const key of PLUGIN_KEYS) {
+        const userValue = userPlugins?.[key];
+        if (userValue === false)
+            continue;
+        const value = userValue || defaultPlugins[key];
+        if (value)
+            result[key] = value;
+    }
+    // Mermaid requires explicit enabling (not auto-detected)
+    const mermaid = userPlugins?.mermaid;
+    if (mermaid && mermaid !== false) {
+        result["mermaid"] = mermaid;
+    }
+    return result;
+}
+//# sourceMappingURL=defaults.js.map

package/dist/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAKb;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAiC;IAC/D,cAAc;IACd,aAAa;CACd,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAU,CAAC;AAErD;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,WAAqC,EACrC,cAAoC;IAEpC,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,SAAS,KAAK,KAAK;YAAE,SAAS;QAClC,MAAM,KAAK,GAAG,SAAS,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC;QAC/C,IAAI,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACjC,CAAC;IAED,yDAAyD;IACzD,MAAM,OAAO,GAAG,WAAW,EAAE,OAAO,CAAC;IACrC,IAAI,OAAO,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QACjC,MAAM,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;IAC9B,CAAC;IAED,OAAO,MAA8B,CAAC;AACxC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { StreamdownTextPrimitive } from "./primitives/StreamdownText.js";
+export { useIsStreamdownCodeBlock, useStreamdownPreProps, } from "./adapters/PreOverride.js";
+export { DEFAULT_SHIKI_THEME } from "./defaults.js";
+export { memoCompareNodes } from "./memoization.js";
+export type { StreamdownTextPrimitiveProps, SyntaxHighlighterProps, CodeHeaderProps, ComponentsByLanguage, StreamdownTextComponents, PluginConfig, ResolvedPluginConfig, CaretStyle, ControlsConfig, LinkSafetyConfig, LinkSafetyModalProps, RemendConfig, RemendHandler, MermaidOptions, MermaidErrorComponentProps, AllowedTags, RemarkRehypeOptions, BlockProps, SecurityConfig, } from "./types.js";
+export { StreamdownContext, parseMarkdownIntoBlocks } from "streamdown";
+export type { StreamdownProps, CodeHighlighterPlugin, DiagramPlugin, MathPlugin, CjkPlugin, HighlightOptions, } from "streamdown";
+export type { BundledTheme, BundledLanguage } from "streamdown";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,uCAAoC;AACtE,OAAO,EACL,wBAAwB,EACxB,qBAAqB,GACtB,kCAA+B;AAChC,OAAO,EAAE,mBAAmB,EAAE,sBAAmB;AACjD,OAAO,EAAE,gBAAgB,EAAE,yBAAsB;AAEjD,YAAY,EACV,4BAA4B,EAC5B,sBAAsB,EACtB,eAAe,EACf,oBAAoB,EACpB,wBAAwB,EACxB,YAAY,EACZ,oBAAoB,EACpB,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,0BAA0B,EAC1B,WAAW,EACX,mBAAmB,EACnB,UAAU,EACV,cAAc,GACf,mBAAgB;AAGjB,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAGxE,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,UAAU,EACV,SAAS,EACT,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { StreamdownTextPrimitive } from "./primitives/StreamdownText.js";
+export { useIsStreamdownCodeBlock, useStreamdownPreProps, } from "./adapters/PreOverride.js";
+export { DEFAULT_SHIKI_THEME } from "./defaults.js";
+export { memoCompareNodes } from "./memoization.js";
+// Re-export streamdown context and utilities
+export { StreamdownContext, parseMarkdownIntoBlocks } from "streamdown";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,uCAAoC;AACtE,OAAO,EACL,wBAAwB,EACxB,qBAAqB,GACtB,kCAA+B;AAChC,OAAO,EAAE,mBAAmB,EAAE,sBAAmB;AACjD,OAAO,EAAE,gBAAgB,EAAE,yBAAsB;AAwBjD,6CAA6C;AAC7C,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC"}

package/dist/memoization.d.ts

@@ -0,0 +1,10 @@
+import type { ReactNode } from "react";
+/**
+ * Memo comparison function for components with children prop.
+ * Inspired by react-markdown's approach.
+ */
+export declare function memoCompareNodes<T extends {
+    children?: ReactNode;
+    [key: string]: unknown;
+}>(prev: Readonly<T>, next: Readonly<T>): boolean;
+//# sourceMappingURL=memoization.d.ts.map

package/dist/memoization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoization.d.ts","sourceRoot":"","sources":["../src/memoization.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAmBvC;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,CAAC,SAAS;IAAE,QAAQ,CAAC,EAAE,SAAS,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,EAC1D,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,CAU/C"}

package/dist/memoization.js

@@ -0,0 +1,30 @@
+"use client";
+function isReactElement(node) {
+    return (typeof node === "object" && node !== null && "type" in node && "key" in node);
+}
+/**
+ * Compares two ReactNode values for shallow equality.
+ */
+function compareNodes(a, b) {
+    if (a === b)
+        return true;
+    if (!isReactElement(a) || !isReactElement(b))
+        return false;
+    return a.type === b.type && a.key === b.key;
+}
+/**
+ * Memo comparison function for components with children prop.
+ * Inspired by react-markdown's approach.
+ */
+export function memoCompareNodes(prev, next) {
+    const prevKeys = Object.keys(prev).filter((k) => k !== "children");
+    const nextKeys = Object.keys(next).filter((k) => k !== "children");
+    if (prevKeys.length !== nextKeys.length)
+        return false;
+    for (const key of prevKeys) {
+        if (prev[key] !== next[key])
+            return false;
+    }
+    return compareNodes(prev.children, next.children);
+}
+//# sourceMappingURL=memoization.js.map

package/dist/memoization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoization.js","sourceRoot":"","sources":["../src/memoization.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAMb,SAAS,cAAc,CAAC,IAAa;IACnC,OAAO,CACL,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,CAC7E,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,CAAY,EAAE,CAAY;IAC9C,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3D,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAE9B,IAAiB,EAAE,IAAiB;IACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC;IAEnE,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACtD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IAC5C,CAAC;IAED,OAAO,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;AACpD,CAAC"}

package/dist/primitives/StreamdownText.d.ts

@@ -0,0 +1,60 @@
+import { type StreamdownProps } from "streamdown";
+import type { SecurityConfig } from "../types.js";
+/**
+ * A primitive component for rendering markdown text using Streamdown.
+ *
+ * Streamdown is optimized for AI-powered streaming with features like:
+ * - Block-based rendering for better streaming performance
+ * - Incomplete markdown handling via remend
+ * - Built-in syntax highlighting via Shiki
+ * - Math, Mermaid, and CJK support via plugins
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * <StreamdownTextPrimitive />
+ *
+ * // With plugins
+ * import { code } from "@streamdown/code";
+ * import { math } from "@streamdown/math";
+ *
+ * <StreamdownTextPrimitive
+ *   plugins={{ code, math }}
+ *   shikiTheme={["github-light", "github-dark"]}
+ * />
+ *
+ * // Disable a specific plugin
+ * <StreamdownTextPrimitive plugins={{ code: false }} />
+ *
+ * // Migration from react-markdown (compatibility mode)
+ * <StreamdownTextPrimitive
+ *   components={{
+ *     SyntaxHighlighter: MySyntaxHighlighter,
+ *     CodeHeader: MyCodeHeader,
+ *   }}
+ *   componentsByLanguage={{
+ *     mermaid: { SyntaxHighlighter: MermaidRenderer }
+ *   }}
+ * />
+ * ```
+ */
+export declare const StreamdownTextPrimitive: import("react").ForwardRefExoticComponent<Omit<StreamdownProps, "children" | "components" | "plugins" | "caret" | "controls" | "linkSafety" | "remend" | "mermaid" | "BlockComponent" | "parseMarkdownIntoBlocksFn"> & {
+    components?: import("..").StreamdownTextComponents | undefined;
+    componentsByLanguage?: import("..").ComponentsByLanguage | undefined;
+    plugins?: import("..").PluginConfig | undefined;
+    preprocess?: ((text: string) => string) | undefined;
+    containerProps?: Omit<import("react").ComponentPropsWithoutRef<"div">, "children"> | undefined;
+    containerClassName?: string | undefined;
+    caret?: import("..").CaretStyle | undefined;
+    controls?: import("..").ControlsConfig | undefined;
+    linkSafety?: import("..").LinkSafetyConfig | undefined;
+    remend?: import("..").RemendConfig | undefined;
+    mermaid?: import("streamdown").MermaidOptions | undefined;
+    parseIncompleteMarkdown?: boolean | undefined;
+    allowedTags?: import("..").AllowedTags | undefined;
+    remarkRehypeOptions?: import("remark-rehype").Options | undefined;
+    security?: SecurityConfig | undefined;
+    BlockComponent?: StreamdownProps["BlockComponent"] | undefined;
+    parseMarkdownIntoBlocksFn?: ((markdown: string) => string[]) | undefined;
+} & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=StreamdownText.d.ts.map

package/dist/primitives/StreamdownText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamdownText.d.ts","sourceRoot":"","sources":["../../src/primitives/StreamdownText.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAI9D,OAAO,KAAK,EAAE,cAAc,EAAgC,oBAAiB;AA8B7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;kDAwHnC,CAAC"}